home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Turnbull China Bikeride
/
Turnbull China Bikeride - Disc 2.iso
/
STUTTGART
/
FROMUTS
/
WARFARIN
/
!Warfarin
/
!ReadMe
next >
Wrap
Text File
|
1990-08-25
|
4KB
|
112 lines
Documentation for Warfarin V1.00
--------------------------------
Installing Warfarin
-------------------
Simply load the module by typing *Warfarin from inside the !Warfarin directory.
There are no * commands supplied: Warfarin activates as soon as it has loaded.
The only way to remove it is *RMKill it (or hard reset/switch off). You can do
*Help Warfarin, but it doesn't tell you anything astounding.
I have supplied an application directory, !Warfarin, containing a trivial
!Run and a silly !Sprites file, but it seems pointless because you need
the mouse to work in order to load it ! Actually, you can type *!Warfarin
from the command line, so all is not lost. If you are being sensible, you
should copy the Warfarin module to your Library directory so that you can
type *Warfarin from anywhere.
What does Warfarin do ?
-----------------------
It allows the mouse pointer to be moved by using either Alt key in combination
the cursor keys (and Insert, Home and Page Up) to move the mouse (and press the
left, middle and right buttons). Since the source is supplied, it is relatively
easy to change the keys used (the 'eventtrap' routine is fully commented). You
may also want to change the mouse step 'boost' (because the step of 1 pixel
using the arrow keys is tortuous, I add 4 to the mouse step before multiplic-
ation of the X and Y change) - it's a variable called 'mouseboost%'. You could
change your *Configure MouseStep setting instead of course.
Why's it called Warfarin ?
--------------------------
Warfarin is a crystalline insoluble substance (C H O ) used as a rodenticide.
19 16 4
Hence, my module is used when your mouse is dead !
I should remind readers that Warfarin is the patent name owned by
Wisconsin Alumni Research Foundation, derived from their initials and the
compound courmarin (C H O ).
9 6 2
How do I use it ?
-----------------
Press Alt and, whilst still holding down Alt, press one of the four
cursor keys to move the mouse pointer. It will move smoothly at the rate
that you've set for *Configure MouseStep. Pressing Alt-Insert will act as
if you've pressed the left mouse button. Alt-Home (middle button) and
Alt-Page Up (right button) also simulate mouse button presses.
NOTE: When Alt is held down, the normal text cursor will still move when the
cursor keys are pressed. The normal mouse buttons are also DISABLED
whilst Alt is depressed, but you can still move the mouse.
Technical Section
-----------------
Well, I had some problems getting this one to work ! I tried:
1) OS_GenerateEvent 10 to force a button pressed event...the OS ignores it.
2) Forcing nine bytes into the mouse buffer every vsync - also failed.
3) Setting the mouse position with OS_Word 21 (param 3). This worked, but
you can't set the mouse button state with it.
4) Trapping OS_Mouse itself. This worked after I used the example in the
manual - boy, modifying return parameters on a vector is hard work. I
used the OS_Mouse vector to 'tweak' the mouse button states, but it's
no good for updating the mouse position.
The Warfarin module survives a soft reset.
Revision History
----------------
Version 1.00
------------
* The mouse on the A440 I use at work refused to move in a sensible fashion
and it was like trying to play a game of 'can I get the mouse to move in
the direction I want ?'. Since the Atari ST can move the mouse via the
keys, I simply couldn't let a vastly inferior machine get away with a
useful feature that the Archimedes doesn't have.
Future Enhancements
-------------------
* When Alt is held down, the cursor keys shouldn't move the normal text cursor.
* I'll probably have a 'speedup key' to double the speed of the mouse movement
if it has a long way to travel.
A Plea From The Author
----------------------
If you make some USEFUL changes to the source or fix any bugs, can you please
send me those changes to the following address:
Snail Mail JANET e-mail
---------- ------------
Richard K. Lloyd, rkl@uk.ac.liv.cs.mva
1, Banks Road,
Lower Heswall,
Wirral,
Merseyside. L60 9JS
P.S. Anyone know where I can buy an Archimedes mouse cheaply ?